home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / chess / conver.zip / CONVER.TXT
Text File  |  1994-05-07  |  13KB  |  381 lines
  1.  
  2.  
  3.  
  4.                ==Chess File and Database Conversions==
  5.                =======================================
  6.  
  7. Categories
  8. ==========
  9.  
  10.   ASCII formats
  11.  
  12.     1. NTR (Nunn's Text Reader format; ChessBase text format)
  13.     2. NIC (NiCBase Text format)
  14.     3. PGN (Portable Game Notation format)
  15.     4. all others
  16.  
  17.   Proprietary Database formats
  18.  
  19.     1. CBASE (ChessBase)
  20.     2. NBASE (NiCBase)
  21.     3. CASST (Chess Assistant)
  22.     4. all others
  23.  
  24.   Taking any point from items 1 to 3 of each list, it is possible to get
  25.   to all others.
  26.  
  27.  
  28. Samples of ASCII formats
  29. ========================
  30.  
  31. --NTR--
  32.  
  33.   Kramnik,V - Anand,V
  34.   Groningen PCA Qualifiers (11) 1993
  35.   1.d4 d5 2.c4 c6 3.cxd5 cxd5 4.Nf3 Nf6 5.Nc3 Nc6 6.Bf4 Bf5
  36.   7.e3 e6 8.Bd3 Bxd3 9.Qxd3 Bd6 10.Bxd6 Qxd6 11.0-0 1/2
  37.  
  38. --NIC--
  39.  
  40.   Keycode: SL 5.5
  41.   Source: Q94
  42.   White: Kramnik,Vladimir  Title: IGM  Elo: 2725
  43.   Black: Anand,Vishwanathan  Title: IGM  Elo: 2740
  44.   Place: Groningen PCA Qualifiers  Round: 11  Year: 1993
  45.   1.d4 d5 2.c4 c6 3.cd5 cd5 4.Nf3 Nf6 5.Nc3 Nc6 6.Bf4 Bf5
  46.   7.e3 e6 8.Bd3 Bd3 9.Qd3 Bd6 10.Bd6 Qd6 11.0-0 1/2
  47.   Info: Both qualified
  48.   Annotator: Kramnik/Anand
  49.  
  50. --PGN--
  51.  
  52.   [Event "PCA Qualifiers"]
  53.   [Site "Groningen, NED"]
  54.   [Date "1993.12.30"]
  55.   [Round "11"]
  56.   [White "Kramnik,V"]
  57.   [Black "Anand,V"]
  58.   [Result "1/2-1/2"]
  59.  
  60.   1. d4 d5 2. c4 c6 3. cxd5 cxd5 4. Nf3 Nf6 5. Nc3 Nc6 6. Bf4 Bf5
  61.   7. e3 e6 8. Bd3 Bxd3 9. Qxd3 Bd6 10. Bxd6 Qxd6 11. O-O 1/2-1/2
  62.  
  63. The three formats above can have a number of variations and hold
  64. additional fields. PGN, for one, can have more than 30 keyword fields but
  65. the seven above are always required in the order shown.
  66.  
  67. In NTR format, a "loaded" first-line header might look like this,
  68.  
  69.   Shipman,Joe (2354) - Anderson,C (2294) [B21]
  70.  
  71. In the above line, ratings have been included and the ECO (Encyclopedia
  72. of Chess Openings) code for a Morra Gambit.
  73.  
  74. And finally, some additional PGN fields:
  75.  
  76.   [WhiteElo "2354"]
  77.   [BlackElo "2294"]
  78.   [ECO "B21"]
  79.   [NIC "SI 48.2.1"]
  80.  
  81. Within chess notation itself between the various formats there are also
  82. some subtle differences. NIC format tends toward compact notation, often
  83. not indicating captures, e.g., 10.Bxd6 could, on option, be shown as Bd6.
  84. PGN mandates a promotion style of a8=Q while others allow a simple a8Q.
  85. Castling can be shown variously as 0-0 (zeros) or O-O (capital letters).
  86. Sometimes there must be a space after the period of a move number (PGN)
  87. and other times this is optional. These differences may seem
  88. insignificant but when it comes to computers they are the number-one
  89. reason for trouble during conversion runs!
  90.  
  91. Overview of Proprietary formats
  92. ================================
  93.  
  94. These cannot be shown in sample form since they are coded in binary. The
  95. principle reason for this is to reduce storage space and speed execution,
  96. but vendors also know it helps keep a "captive" audience. <g>
  97.  
  98. CBASE - ChessBase proprietary
  99. -----
  100. A downloaded, unzipped file of CBase games will always include at least
  101. two files, the larger having an extension of .CBF, and the smaller, an
  102. index, having .CBI. You may also find files with .CPO and .CKO extensions
  103. and possibly .DOC files. Unless you are using ChessBase, the only ones
  104. that are really necessary are .CBF & .CBI. In CBase, if an accompanying
  105. DOC file has the same filename as the .CBF and .CBI files, it will
  106. automatically display when that database is selected. A number of Forum
  107. library files include these DOC files referencing tournament
  108. cross-tables or general information on the file itself. You can also view
  109. the .DOC file with a text editor or word processor.
  110.  
  111. NBASE - NiCBase proprietary
  112. -----
  113. For NiCBase databases there are several files. First, the games and a set
  114. of game lengths are stored in files with .G30 and .I30 extensions,
  115. respectively. For a complete database, there is a .DBS file that lists
  116. all the other files of the database and their location; a .KEY file,
  117. which contains information about the games classifications; a file of
  118. positions, with .POS extension; and a pointer file, with .PTR extension.
  119. A valid database must have all 6 files. "Gamefiles" can be made with only
  120. .G30 and .I30 formats, however.
  121.  
  122. Why have a full database when you can have simpler gamefiles? Because a
  123. database can be used to classify new games, and information and position
  124. searches are much faster (for the same number of games!) in a full
  125. database. This point also applies to the other chess databases as well.
  126.  
  127. CASST - Chess Assistant proprietary
  128. -----
  129. Here there are 14 different files to make up a database! The largest, the
  130. .BGM extension, holds the game data and the .LIB holds library
  131. information--a list of player names and tournament (place) names. There
  132. has been little study so far of the internal structure of a CA db but a
  133. best guess would be that many of them are indexes to speed data
  134. searches--a strong point for CA. One will not encounter any CA files in
  135. the CIS libraries--or NiCBase files either for that matter--since the only
  136. proprietary format which is standard to the Chess Forum is CBase. So far
  137. no one has come up with any utility which will perform a direct
  138. conversion of a CA db to another format. The only method is to have CA
  139. print games in ASCII to a file and then convert to other formats from the
  140. ASCII (covered as cafilter, below).
  141.  
  142.  
  143. Conversion Cross-Table
  144. ======================
  145.  
  146.                 --------ASCII--------    ------Proprietary------
  147.  
  148. From       To:  NTR      NIC      PGN    CBASE    NBASE    CASST
  149. ----            ---      ---      ---    -----    -----    -----
  150.  
  151.   NTR            -        1        2        3        4        5
  152.   NIC            6        -        7        8        9       10
  153.   PGN           11       12        -       13       14       15
  154.  
  155.   CBASE         16       17       18        -       19       20
  156.   NBASE         21       22       23       24        -       25
  157.   CASST         26       27       28       29       30        -
  158.  
  159.  
  160. Conversion Items
  161. ----------------
  162. (All 'FORMATS' are in UPPER case; conversion 'utilities' are in lower case.
  163. A following section briefly describing each utility.)
  164.  
  165. (1)  NTR->chessu->NIC    (Macintosh utility ChessU)
  166.  
  167. (2)  NTR->normal->PGN    (Lib 5 freeware Normal.exe)
  168.  
  169. (3)  NTR->reader->CBASE  (Nunn's Text Reader.exe main program)
  170.  
  171. (4)  NTR->reader->CBASE->nicconvert->NBASE
  172.      (or) normal->PGN->cbascii->CBASE->nicconvert->NBASE
  173.  
  174. (5)  NTR->reader->CBASE->cb2ca->CASST
  175.      (or) normal->PGN->cbascii->CBASE->cb2ca->CASST
  176.  
  177. (6)  NIC->wrdmcr->NTR     (Lib 5 freeware MS/Word macro)
  178.      (or) nic2cb->NTR    (Lib 5 freeware DOS macro)
  179.      (or) chessu->NTR    (Mac)
  180.  
  181. (7)  NIC->wrdmcr/nic2cb->NTR->normal->PGN
  182.  
  183. (8)  NIC->wrdmcr/nic2cb->NTR->normal->PGN->cbascii->CBASE
  184.  
  185. (9)  NIC->wrdmcr/nic2cb->NTR->normal->PGN->cbascii->CBASE->nicconvert->NBASE
  186.  
  187. (10) NIC->wrdmcr/nic2cb->NTR->reader->CBASE->cb2ca->CASST
  188.      (or) wrdmcr/nic2cb->NTR->normal->PGN->cbascii->CBASE->cb2ca->CASST
  189.  
  190. (11) PGN->normal->NTR
  191.  
  192. (12) PGN->normal->NTR->(Mac)->chessu->NIC (requires two platforms)
  193.  
  194. (13) PGN->cbascii->CBASE
  195.      (or)->normal->NTR->reader->CBASE
  196.  
  197. (14) PGN->cbascii->CBASE->nicconvert->NBASE
  198.  
  199. (15) PGN->cbascii->CBASE->cb2ca->CASST
  200.      (or)->normal->NTR->reader->CBASE->cb2ca->CASST
  201.  
  202. (16) CBASE->print->NTR
  203.  
  204. (17) CBASE->nicconvert->NBASE->print->NIC
  205.  
  206. (18) CBASE->cbascii(export)->PGN
  207.  
  208. (19) CBASE->nicconvert->NBASE
  209.  
  210. (20) CBASE->cb2ca->CASST
  211.  
  212. (21) NBASE->print->NIC->wrdmcr/nic2cb->NTR
  213.       (or)->cbworld->CBASE->print->NTR
  214.       (or)->cbworld->CBASE->cbascii->PGN->normal->NTR
  215.  
  216. (22) NBASE->print->NIC
  217.  
  218. (23) NBASE->cbworld->CBASE->print->NTR->normal->PGN
  219.  
  220. (24) NBASE->cbworld->CBASE
  221.  
  222. (25) NBASE->nic2ca->CASST
  223.  
  224. (26) CASST->print->cafilter->PGN->normal->NTR
  225.  
  226. (27) CASST->print->cafilter->PGN->normal->NTR->(Mac)->chessu->NIC
  227.  
  228. (28) CASST->print->cafilter->PGN
  229.  
  230. (29) CASST->print->cafilter->PGN->cbascii->CBASE
  231.       (or)->print->cafilter->PGN->normal->NTR->reader->CBASE
  232.  
  233. (30) CASST->print->cafilter->PGN->cbascii->CBASE->nicconvert->NBASE
  234.  
  235.  
  236. Conversion Utilities
  237. ====================
  238.  
  239. reader - Reader.exe  (Nunn's Text Reader main program)
  240. ------
  241. (as referenced in above chart) Nunn's Text Reader, also NTR (not to be
  242. confused with the format), is a commercially available utility from
  243. ChessBase, Inc. priced around 60US$ which will take NTR formatted games,
  244. converting them to a CBase db. READER.exe is somewhat temperamental to
  245. the extent that all games used in a single run must have a very exact
  246. notation style. However, program settings allow various notations on a
  247. run-by-run basis. If you have mixed games it is a good idea to run
  248. NORMAL.exe first to get them in a common syntax. The move model created
  249. by NORMAL is: '19.exd4 Bxc6 20.0-0 a1Q 1/2'. It has been found helpful to
  250. eliminate the '+' check setting when running READER.exe as, otherwise, it
  251. has the idiosyncrasy of rejecting games with discovered checks!
  252.  
  253. cbworld - CBWorld
  254. -------
  255. This is a utility available from CBase for converting NiC databases.
  256.  
  257. nicconvert - NiCConvert
  258. ----------
  259. This utility is available from NiCBase to convert CBase databases to
  260. NiC internal database format.
  261.  
  262. cb2ca - Cb2ca.exe
  263. -----
  264. This is a utility included with the purchase of Chess Assistant which
  265. converts CBase database files to CA internal format.
  266.  
  267. nic2ca - Nic2ca.exe
  268. ------
  269. This is a utility included with the purchase of Chess Assistant which
  270. converts NBase database files to CA internal format.
  271.  
  272. nic2cb - NIC2CB Macros
  273. ------
  274. A utility written by Bob Appleby (Bob the Geordie), a Forum member, for
  275. use with the QEdit text editor program. Bob is currently writing a new
  276. set of macros to run on the latest version, QEdit 3.0.
  277.  
  278. cbascii - CBAscii.exe
  279. -------
  280. CBAscii is a program originally developed over at Internet and is now in
  281. our Library 5 under the name CBASCII.ZIP. It will import and export ASCII
  282. to/from CBase format but only using PGN format ASCII. If your games are
  283. not in PGN format, first use Normal.exe (below). When using CBAscii.exe you
  284. will not be able to preserve ELO ratings. If you wish to keep them tagged
  285. onto the player's names, you will need to take the longer route,
  286. substituting Normal.exe and Reader.exe for a CBAscii.exe run.
  287.  
  288. normal - Normal.exe
  289. ------
  290. Normal.exe converts game headers between NTR and PGN format and also
  291. verifies/converts notation. It is available in Library 5 as NORMAL.ZIP.
  292. Conversions are handled by setting run switches. When creating a final
  293. NTR format file for Reader.exe make sure you have output switches set as
  294. follows: fmtOut=NTR, convertHdrs=1, bracketOut=0, comLevelOut=0. Prior to
  295. using CBAscii, the switches should be the same except, 'fmtOut=PGN' &
  296. 'combEventOut=1'. (See Appendix below for configuration files which can
  297. be copied and pasted into your Normal directory.)
  298.  
  299. cafilter - CAFilter, CA->PGN
  300. --------
  301. CAfilter requires first that a "dataset" of games be chosen in CA. These
  302. then are "printed" to a file. CAFilter then converts the file to PGN
  303. format. See the instructions which come with the program--available in
  304. Library 5.
  305.  
  306. wrdmcr - Wrdmcr Macros
  307. ------
  308. This file exists in Library 5 called "WRDMCR.ZIP" which contains two
  309. files. One is a simple ASCII text file that explains the macros. The
  310. other file has the name NORMAL.DOT (not to be confused with Normal.exe!)
  311. and is a Word for Windows 2 template that contains the macros. If you
  312. don't have Windows 3.1 and Word for Windows 2 (or later), this file will
  313. be of no use to you!
  314.  
  315. However, if you do use this full environment, these macros will be very
  316. useful. They take NIC ASCII format files, such as are common in the Forum
  317. Libraries, and change them into NTR format.
  318.  
  319. chessu - Chess Utility 1 (Macintosh)
  320. ------
  321. ChessU is an "ASCII database" processing utility which comes with the
  322. ChessPub Mac ASCII chess reader and publisher. The combined package is
  323. available for about 35US$. Contact Paul Onstad, CIS, 70641.3236 for
  324. ordering and information.
  325.  
  326.  
  327. Appendix
  328. ========
  329.  
  330. Summary Map of common Conversion Paths:
  331. --------------------------------------
  332.  
  333.      /->normal->PGN->cbascii->-\        /--<-cbworld--<--\
  334.    /                             \    /                    \
  335. NTR->---reader->------------------->CBASE---->-nicconvert--->-NBASE->NIC-<
  336.    \                                                               /   /
  337.      \->----->-(Macintosh)->-chessu->-NIC->-(PC)->----->------->-/   /
  338.        \                                                           /
  339.          \-<--------<-nic2cb (or) wrdmcr-<---------------------<-/
  340.  
  341.  
  342. Normal.exe configuration files
  343. ------------------------------
  344.  
  345. * NTR->PGN preparation for CBASCII import
  346. * copy/paste and "Save as" n2pfin.cfg in your Normal directory
  347. [fmtIn=NTR]
  348. [fmtOut=PGN]
  349. [bracketIn="{}"]
  350. [bracketIn="[]"]
  351. [bracketIn="()"]
  352. [braceTrans=1]
  353. [combEventOut=1]
  354. [comLevelOut=0]
  355. [bracketOut=0]
  356. [convertHdrs=1]
  357.  
  358. * PGN->NTR preparation for Nunn's Text Reader.exe import
  359. * copy/paste and "Save as" p2nfin.cfg in your Normal directory
  360. [fmtIn=PGN]
  361. [fmtOut=NTR]
  362. [bracketIn="{}"]
  363. [bracketIn="[]"]
  364. [bracketIn="()"]
  365. [bracketOut=0]
  366. [comLevelOut=0]
  367. [convertHdrs=1]
  368.  
  369.  
  370. Contributors
  371. ============
  372.  
  373. Chess Coaches,
  374.  
  375.    Mitch White   72162,2506
  376.    Joe Reynolds  71031,1655
  377.    Paul Onstad   70641,3236
  378.  
  379.  
  380. [end of file]
  381.